Skip to content

qdisc: expose fq throttled events as node_qdisc_throttled_total - #3792

Open
2matzzz wants to merge 1 commit into
prometheus:masterfrom
2matzzz:qdisc-throttled
Open

qdisc: expose fq throttled events as node_qdisc_throttled_total#3792
2matzzz wants to merge 1 commit into
prometheus:masterfrom
2matzzz:qdisc-throttled

Conversation

@2matzzz

@2matzzz 2matzzz commented Aug 20, 2026

Copy link
Copy Markdown

This adds node_qdisc_throttled_total (counter, device/kind labels) to the qdisc collector, sourced from QdiscInfo.Throttled.

The ema/qdisc library has parsed the fq qdisc's extended stats (Throttled, among others) since ema/qdisc@e2e5ae4 (2017-05-24) — merged one day after #580 introduced this collector — but the field was never wired into a metric. This follows the same pattern as #1732, which wired the library's backlog/qlen fields through.

Use case: with fq used for egress pacing (maxrate), this counter shows whether and how often pacing actually engages — packets are delayed rather than dropped, so none of the existing drop/overlimit metrics capture it. For non-fq qdiscs the value is 0, consistent with the collector's uniform metric emission.

Testing: fixtures updated (results.json, e2e-output.txt, e2e-64k-page-output.txt); verified by running the exporter with --collector.qdisc.fixtures and confirming the new series alongside unchanged existing ones.

cc @SuperQ

The ema/qdisc library has parsed the fq qdisc's extended statistics
(including the throttled counter) since 2017, one day after this
collector was merged, but the field was never wired into a metric.

Expose it as node_qdisc_throttled_total so that users running fq with
maxrate pacing can observe how often the qdisc throttles transmission,
e.g. to verify whether egress pacing is actually engaging. For qdiscs
other than fq the value is reported as 0, consistent with how the
other uniform per-qdisc metrics behave.

Assisted-by: Claude Code
Signed-off-by: Yusuke Matsumoto <2matzzz@gmail.com>
@2matzzz
2matzzz marked this pull request as draft August 20, 2026 10:57
@2matzzz
2matzzz marked this pull request as ready for review August 20, 2026 13:02
@ArthurSens

Copy link
Copy Markdown
Member

/workflow-approve

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants